Class Tab

分頁

Google 文件文件中的分頁。 

// Get all of the first-level tabs (tabs that are not nested within a parent
// tab) in the document.
// TODO(developer): Replace the ID with your own.
const tabs = DocumentApp.openById('123abc').getTabs();

// Get a specific tab based on the tab ID.
// TODO(developer): Replace the IDs with your own.
const tab = DocumentApp.openById('123abc').getTab('123abc');

方法

方法傳回類型簡短說明
asDocumentTab()DocumentTab以 DocumentTab 的形式擷取分頁內容。
getChildTabs()Tab[]擷取在這個分頁中巢狀的子分頁。
getId()String擷取分頁的 ID。
getIndex()Integer擷取父項中分頁的索引值 (從 0 開始)。
getTitle()String擷取分頁的標題。
getType()TabType擷取分頁類型。

內容詳盡的說明文件

asDocumentTab()

以 DocumentTab 的形式擷取分頁內容。

回攻員

DocumentTab：分頁以 DocumentTab 格式指定。

getChildTabs()

擷取在這個分頁中巢狀的子分頁。

回攻員

Tab[]：這個分頁內嵌套的子分頁。

授權

使用這個方法的腳本需要具備下列一或多個範圍的授權：

  • https://www.googleapis.com/auth/documents.currentonly
  • https://www.googleapis.com/auth/documents

getId()

擷取分頁的 ID。

回攻員

String：分頁 ID。

授權

使用這個方法的腳本需要具備下列一或多個範圍的授權：

  • https://www.googleapis.com/auth/documents.currentonly
  • https://www.googleapis.com/auth/documents

getIndex()

擷取父項中分頁的索引值 (從 0 開始)。

回攻員

Integer：父項中分頁的索引。

授權

使用這個方法的腳本需要具備下列一或多個範圍的授權：

  • https://www.googleapis.com/auth/documents.currentonly
  • https://www.googleapis.com/auth/documents

getTitle()

擷取分頁的標題。

回攻員

String：分頁標題。

授權

使用這個方法的腳本需要具備下列一或多個範圍的授權：

  • https://www.googleapis.com/auth/documents.currentonly
  • https://www.googleapis.com/auth/documents

getType()

擷取分頁類型。

請使用這個方法判斷這個 Tab 的內容類型，然後再使用 asDocumentTab() 轉換為更具體的類型。

const tab = DocumentApp.getActiveDocument().getActiveTab();
// Use getType() to determine the tab's type before casting.
if (tab.getType() === DocumentApp.TabType.DOCUMENT_TAB) {
  // It's a document tab, write some text to it.
  tab.asDocumentTab().setText('Hello World!');
} else {
  // There are currently no types other than DOCUMENT_TAB.
}

回攻員

TabType - 分頁類型。

授權

使用這個方法的腳本需要具備下列一或多個範圍的授權：

  • https://www.googleapis.com/auth/documents.currentonly
  • https://www.googleapis.com/auth/documents